Inject a [SYSTEM] event into a live runtime session

curl --request POST \
  --url https://api.talkzilla.app/v1/public/runtime/sessions/{sessionId}/system-events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "<string>"
}
'

{
  "data": {
    "event_id": "evt_...",
    "topic": "<string>"
  }
}

Public API

Inject a [SYSTEM] event into a live runtime session

External-automation surface for the same persist+publish pipeline operator browsers use via the realtime-gateway. Persists a runtime_session_events row and publishes system.event.injected on the session topic. The user-api SessionIntentConsumer applies the effect to runtime state.

Requires scope api.write. Audit row records actor_kind=‘api’ plus the API token’s id. 503 returned when the realtime broker is unavailable so callers can retry rather than depending on the consumer’s catch-up scan.

POST

public

runtime

sessions

{sessionId}

system-events

Inject a [SYSTEM] event into a live runtime session

curl --request POST \
  --url https://api.talkzilla.app/v1/public/runtime/sessions/{sessionId}/system-events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "<string>"
}
'

{
  "data": {
    "event_id": "evt_...",
    "topic": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Tenant-managed API tokens minted under Settings → Developer API. Scopes are api.read for GETs and api.write for mutating calls.

Path Parameters

sessionId

string

required

Example:

"rs_01H..."

Body

application/json

kind

enum<string>

required

Available options:

notify,

end-session

message

string

Required when kind=notify; max 4000 chars.

Maximum string length: 4000

Response

Event accepted; will be applied on the next consumer cycle.

data

object

Show child attributes

Resolve tenant context Billing provider webhook ingress